home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / hd / smartcopy1_2.lha / SmartCopy / SmartCopy.doc < prev    next >
Encoding:
Text File  |  1994-11-28  |  11.5 KB  |  276 lines
  1.                          SmartCopy v1.2
  2.                           User's Manual
  3.                 (C) 1994 Rask Ingemann Lambertsen
  4.  
  5.  
  6.                            Disclaimer.
  7.                            ¯¯¯¯¯¯¯¯¯¯¯
  8.  
  9.    This program is provided "as is" without warranty of any kind,
  10. either  expressed  or  implied, including, but no limited to, the
  11. implied warranty of fitness for a particular purpose.  The entire
  12. risk  as  to the results, reliability and performance of this
  13. program is assumed by you.
  14.  
  15.  
  16.  
  17.                           Distribution.
  18.                           ¯¯¯¯¯¯¯¯¯¯¯¯¯
  19.  
  20.    This program is freely distibutable if, and only if, the
  21. following conditions are met:
  22. 1. Program and documentation must not be changed in any way,
  23.    except for archiving with an archiver, for which the
  24.    corresponding unarchiver will run on any CPU type used in
  25.    Amigas at the time of distribution.
  26. 2. Program, documentation and the icons for the program and the
  27.    documentation must be distributed together.
  28. 3. The filenames of the program, documentation and icons must not
  29.    be changed (this especially applies to Fred Fish, who has
  30.    had the habbit of changing filenames to upper case).
  31. 4. Only a nominal and small fee for copying is charged, unless
  32.    some sort of media is supplied with SmartCopy, in which case
  33.    it is allowed to add the cost of that media to the charge.
  34. 5. SmartCopy or parts of it must not be sold in combination with
  35.    or as part of commercial software without my written
  36.    permission.
  37.  
  38.  
  39.  
  40.                           Introduction.
  41.                           ¯¯¯¯¯¯¯¯¯¯¯¯¯
  42.  
  43.    SmartCopy was written to easily transfer files from a harddisk
  44. to multiple disks. It automatically finds out when the disk is
  45. full and prompts for another one. This is useful for copying a
  46. bunch of pictures, samples, modules or whatever to disks, like a
  47. picture, sample or module collection. SmartCopy uses a GUI to be
  48. as user-friendly as possible (meaning that you don't need to mess
  49. around with shells/CLIs or directory utilities).
  50.  
  51.    One of my major goals was to make a very fast yet reliable
  52. copy routine (like the one in C:Copy). This became a major goal
  53. especially after I found out that the copy routine in SID2 is not
  54. just slow, but also UNRELIABLE when copying files from CrossDOS
  55. disks with text filtering enabled.
  56.  
  57.  
  58.  
  59.                       System requirements.
  60.                       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  61.  
  62.    Any Amiga with
  63. - 20 kb of CHIP memory + 20 kb of any memory (approx.).
  64. - at least Amiga OS 2.04 or later.
  65.  
  66. Amiga OS 2.1 or later is recommended because of the MUCH faster
  67. file requester.
  68.  
  69. For the technies, here is more precise requirements:
  70. exec.library      version 33+
  71. dos.library       version 36+
  72. intuition.library version 36+
  73. utility.library   version 36+
  74. asl.library       version 36+
  75. gadtools.library  version 37+
  76.  
  77. dos.library version 37+ is recommended because version 36
  78. contains many bugs.
  79. asl.library version 38+ is recommended because version 36 and
  80. version 37 are very slow.
  81.  
  82.  
  83.  
  84.                           Installation.
  85.                           ¯¯¯¯¯¯¯¯¯¯¯¯¯
  86.  
  87.    As simple as it can be: Copy SmartCopy and it's icon to the
  88. directory where you want to install it. From Workbench you simply
  89. drag SmartCopy to it's destination.
  90.  
  91.  
  92.  
  93.                              Usage.
  94.                              ¯¯¯¯¯¯
  95.  
  96. SmartCopy can be started from either Workbench or Shell/CLI. You
  97. will then see the main window. It contains the following gadgets:
  98.  
  99. "Add files..."  Brings up a file requester so you can add files to
  100.                 the file list (see below).
  101.                 Keyboard short-cut: "a" or "A".
  102.  
  103. "Copy files"    Copies the files in the file list (see below) to
  104.                 the destination device (see below). Optionally, a
  105.                 directory on the destination device can be
  106.                 specified (see below). If you haven't selected a
  107.                 destination device, you will be informed about
  108.                 it, and the operation will be aborted.
  109.                 Files that don't fit on the destination device
  110.                 (see "Disk space check" below) will not be
  111.                 copied and will not be removed from the list. 
  112.                 If a file is successfully copied, its comment,
  113.                 attributes (protection bits) and date is copied
  114.                 too, and the file is removed from the list.
  115.                 If some files didn't fit on the disk, you will be
  116.                 requested to insert a new disk. Inserting a new
  117.                 disk will automatically acknowledge the
  118.                 requester. If you push the "Cancel" button, the
  119.                 operation will be aborted, and those file that
  120.                 were not copied will still be on the list. Else,
  121.                 the whole process will be repeated with the new
  122.                 disk and the files that didn't fit on the previous
  123.                 disk.
  124.                 As files are copied, the list is scrolled so that
  125.                 the file being copies is in the middle (when
  126.                 possible). The file name is also show beneath the
  127.                 list.
  128.                 Keyboard short-cut: "c" or "C".
  129.  
  130. "Clear list..." Puts up a requester asking you to confirm that
  131.                 you really want to clear the file list (see
  132.                 below). If you do, push the "Yes" button and
  133.                 watch the file list be cleared, else push the
  134.                 "No" button, and the operation will be aborted.
  135.                 Keyboard short-cut: "e" or "E".
  136.  
  137. "Find devices"  Scans the system device list for disk type
  138.                 devices. You can use this button if you mount a
  139.                 device after SmartCopy was started. The
  140.                 destination device list will be updated.
  141.                 Warning: Your currently selected device will NOT
  142.                 be reselected, so you will have select it again
  143.                 if you want to copy to that device again.
  144.                 Keyboard short-cut: "d" or "D".
  145.  
  146. "List of files to be copied"    This is where you can see which
  147.                                 files has not yet been copied.
  148.                                 The scroll bar and scroll arrows
  149.                                 on the right side can be used to
  150.                                 scroll the list when SmartCopy is
  151.                                 not copying the files.
  152.  
  153. "Destination device"    This is a list of available disk devices.
  154.                         You can choose one by clicking o its
  155.                         name. This is where SmartCopy will copy
  156.                         the file to. Your current selection is
  157.                         displayed beneath the device list.
  158.  
  159. "Destination dir"       This is where you can enter the name of a
  160.                         directory on the destination device to
  161.                         copy the file to. There is a limit of
  162.                         256 characters for the directory
  163.                         specification. The directory must exist,
  164.                         it will NOT be created.
  165.                         This gadget has on-line help (try pressing
  166.                         the HELP key when it is activated).
  167.                         Keyboard short-cut: "i" or "I".
  168.  
  169. "Disk space check"      Select the type of calculating whether a
  170.                         file fits on the disk or not.
  171.                         "Smart (FFS/OFS)" is for AmigaDOS disks.
  172.                         This is a bit inaccurate for disk
  173.                         formatted with directory caching, though.
  174.                         "Generic" is for other types of disks,
  175.                         like CrossDOS disks.
  176.                         "None" turns off disk space check.
  177.  
  178.  
  179.  
  180.                              Hints.
  181.                              ¯¯¯¯¯¯
  182.  
  183.    If you want to fill your disks as close to 100% as possible,
  184. it will help a lot if you put the biggest files at the top of the
  185. list. This is not necessarily the most efficient way of putting
  186. files on disks, but it is usually very close.
  187.  
  188.  
  189.  
  190.                     What I would like to add.
  191.                     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  192.  
  193.    The first thing I will add to SmartCopy will be a sort-by-size
  194. function, so that you can add your files to the file list in any
  195. order. Also, I will make it easier to select whole directories at
  196. a time (so that you don't have to click every file so select a
  197. whole directory). Other things will be:
  198.  - a way to stop copying files.
  199.  - disk space calculation for PFS (Professional File System)
  200. disks.
  201.  - better screen update when SmartCopy is busy (this is partly a
  202. problem with gadtools.library).
  203.  
  204.  
  205.  
  206.                             History.
  207.                             ¯¯¯¯¯¯¯¯
  208.  
  209. 1.0     (Sometime at the end of 1992)
  210.         Simple GUI file copier with simple disk space check.
  211.         Not released to the public.
  212.  
  213. 1.1     (11-Aug-93)
  214.         Improved disk space check with options for specialized
  215.         calculation of disk space on FFS and OFS. Generic is the old
  216.         space check. Also, disk space check can now be turned off.
  217.         Rearranged GUI to get more space.
  218.         Increased window size.
  219.         File comments and attributes (protection bits) are
  220.         preserved when the files are copied.
  221.         Changed the gadget labels to be User Interface Style Guide
  222.         compliant.
  223.         Added (permanently disabled) "Sort" gadget.
  224.         Added the little logo in the lower right corner.
  225.         Added the option to copy to a directory on the destination.
  226.         SmartCopy will now close and reopen it's window when it
  227.         thinks the user has changes screen resolution. This is to
  228.         help IPrefs close and reopen the Workbench screen.
  229.         Fixed a lot of bugs, including these major ones:
  230.           The device list is now locked and stepped through using OS
  231.           functions, making it safe.
  232.           No longer enters an endless loop when copying empty files.
  233.           No longer enters an endless loop when there is less than
  234.           one (1) byte of free memory.
  235.         Not released to the public.
  236.         Size increased from 6 kb to 13 kb :-(
  237.  
  238. 1.2     (27-Nov-94)
  239.         Fixed disk space check for FFS/OFS disk (the improvements in v1.1
  240.         were barely noticable because I made a stupid mistake). This time
  241.         it REALLY should work.
  242.         FFS and OFS space check is now the same, the old code was almost
  243.         identical for the two cases anyway.
  244.         FFS/OFS disk space check should also work with block sizes other
  245.         that 512 bytes now.
  246.         Fixed the file copy routine so that it can copy from CrossDOS
  247.         devices with text filtering enabled.
  248.         File dates are copied too now.
  249.         No longer requires utility.library version 37, version 36 will do.
  250.         Removed the useless (and permanently disabled) "Sort" button.
  251.         No longer forces the ASL file requester to use any particular
  252.         text for the title and the "OK" button. This looks A LOT better
  253.         when the system is localized to another language than English.
  254.         The code to close and reopen SmartCopy's window has been
  255.         removed as it didn't work as intended. Instead of
  256.         reacting to changes to the screen, it reacted to changes
  257.         in printer settings. Unfortunately, when the window
  258.         reopened, SmartCopy crashed. Even starting a certain word
  259.         processor would make SmartCopy react and crash!
  260.         Reduced size from 13 kb to 10 kb :-)
  261.  
  262.                      Contacting the author.
  263.                      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  264.  
  265.    Send bug reports, suggestions, etc. to (preferably by e-mail)
  266.  
  267.    Rask Ingemann Lambertsen
  268.    Pinievej 20
  269.    Strøby Egede
  270.    4600 Køge
  271.  
  272.    E-mail: Rask Lambertsen <gc948374@gbar.dtu.dk>
  273.        or  Rask Lambertsen <e9864029@ebar.dtu.dk>
  274.  
  275.    Phone: +45 56267951
  276.